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METHODS, SYSTEMS AND COMPUTER PROGRAM PRODUCTS FOR 
COUPLING ELECTRONIC MAIL AND RELATIONAL DATABASE 

FUNCTIONS 



Field of the Invention 
The present invention relates to electronic mail (e-mail) and, more 
5 particulary, to the generation of e-mail. 

Background of the Invention 

In electronic business (e-business), where typically several companies may 
provide similar goods or services, loyalty of customers may be important in the 

10 success of a business. Such loyalty may, for example, be gained by being 

responsive to customers and by maintaining contact with customers on an ongoing 
basis. On tool for customer outreach and relationship building is electronic mail 
(e-mail). In fact, customer feedback (such as registration thank-you notes, target 
marketing offers, and order status updates) can become a positive market 

15 differentiator. 

In such an environment, speed, efficiency, and responsiveness may be 
important to success. Therefore, e-mail outreach to customers should be 
accompHshed in a timely manner and, preferably, as efficiently as possible. 
Accordingly, the quality of the business process implementation can be just as 

20 important as the content of the e-mail message itself. Thus, a need exists for 
efficient e-mail message generation suitable for use, for example, in e-business. 



RSW92O0OO080US1 



Summary of the Invention 

Embodiments of the present invention provide methods, systems and 
computer program products for generating an electronic mail message by 
automatically generating an electronic mail message responsive to an action being 
5 performed on a database entry. In particular embodiments of the present invention, 
performance of an action on the entry in the database is detected and a user defined 
function (UDF) of the database triggered which provides access to an electronic 
mail system. The UDF is triggered in response to the detection of performance of 
the action on the entry. The electronic mail system is accessed utilizing the UDF 

10 to generate the electronic mail message responsive to the UDF being triggered. 

In further embodiments of the present invention, detecting performance of 
the action and triggering a user defined function may be provided by establishing a 
database trigger associated with entries in the database which activates the UDF 
upon an action being performed on the entries associated with the trigger. 

15 Furthermore, the UDF may obtain electronic mail information associated with the 
entry in the database and provide the electronic mail information to an application 
program interface for the electronic mail system. Such an application program 
interface may provide abstract layering for the underlying electronic mail system. 
Also, the UDF may have a first class which obtains the electronic mail information 

20 and a second class which provides the electronic mail message information to the 
electronic mail system. 

In particular embodiments of the present invention, the application program 
interface may be the JavaMail Application Program Interface. Furthermore, the 
action performed on the database entry which causes the trigger to be activated 

25 may be an insertion of the entry into the database. In certain embodiments of the 
present invention, the database is a DB2 database. Also, the electronic mail system 
may execute on a data processing system remote from a data processing system on 
which the database executes. 

As will further be appreciated by those of skill in the art, while described 

30 above primarily with reference to method aspects, the present invention may be 
embodied as methods, apparatus/systems and/or computer program products. 
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Brief Description of the Drawings 
Figure 1 is a block diagram illustrating a system incorporating 
embodiments of the present invention; 

Figure 2 is a block diagram of a data processing system according to 
5 embodiments of the present invention; 

Figure 3 is a more detailed block diagram of a data processing system 
according to embodiments of the present invention; 

Figure 4 is a flowchart illustrating operations according to embodiments of 
the present invention; and 
10 Figure 5 is a flowchart illustrating operations according to further 

embodiments of the present invention. 

Detailed Description of the Invention 

The present invention now will be described more fully hereinafter with 
15 reference to the accompanying drawings, in which illustrative embodiments of the 
invention are shown. This invention may, however, be embodied in many different 
forms and should not be construed as limited to the embodiments set forth herein; 
rather, these embodiments are provided so that this disclosure will be thorough and 
complete, and will fully convey the scope of the invention to those skilled in the 
20 art. 

As will be appreciated by one of skill in the art, the present invention may 
be embodied as a method, data processing system, or computer program product. 
Accordingly, the present invention may take the form of an entirely hardware 
embodiment, an entirely software embodiment or an embodiment combining 

25 software and hardware aspects all generally referred to herein as a "circuit" or 
"module." Furthermore, the present invention may take the form of a computer 
program product on a computer-usable storage medium having computer-usable 
program code embodied in the medium. Any suitable computer readable medium 
may be utilized including hard disks, CD-ROMs, optical storage devices, a 

30 transmission media such as those supporting the Internet or an intranet, or 
magnetic storage devices. 
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Computer program code for carrying out operations of the present invention 
may be written in an object oriented programming language such as Java®, 
Smalhalk or C++. However, the computer program code for carrying out 
operations of the present invention may also be written in conventional procedural 
5 programming languages, such as the "C" programming language. The program 
code may execute entirely on the user's computer, partly on the user's computer, as 
a stand-alone software package, partly on the user's computer and partly on a 
remote computer or entirely on the remote computer. In the latter scenario, the 
remote computer may be connected to the user's computer through a local area 
10 network (LAN) or a wide area network (WAN), or the connection may be made to 
an external computer (for example, through the hitemet using an Internet Service 
Provider). 

.113=3, 

The present invention is described below with reference to flowchart 
illustrations and/or block diagrams of methods, apparatus (systems) and computer 
''4 15 program products according to embodiments of the invention. It will be 

\^ understood that each block of the flowchart illustrations and/or block diagrams, 

and combinations of blocks in the flowchart illustrations and/or block diagrams, 

!i 

□ can be implemented by computer program instructions. These computer program 

Id instructions may be provided to a processor of a general purpose computer, special 

20 purpose computer, or other programmable data processing apparatus to produce a 
machine, such that the instructions, which execute via the processor of the 
computer or other programmable data processing apparatus, create means for 
implementing the functions/acts specified in the flowchart and/or block diagram 
block or blocks. 

25 These computer program instructions may also be stored in a computer- 

readable memory that can direct a computer or other programmable data 
processing apparatus to function in a particular manner, such that the instructions 
stored in the computer-readable memory produce an article of manufacture 
including instruction means which implement the function/act specified in the 

30 flowchart and/or block diagram block or blocks. 



RSW920000080US1 



# 



fn 



The computer program instructions may also be loaded onto a computer or 
other programmable data processing apparatus to cause a series of operational steps 
to be performed on the computer or other programmable apparatus to produce a 
computer implemented process such that the instructions which execute on the 
5 computer or other programmable apparatus provide steps for implementing the 
functions/acts specified in the flowchart and/or block diagram block or blocks. 

Various embodiments of the present invention will now be described with 
reference to the figures. Figure 1 illustrates a system for e-mail generation 
according to embodiments of the present invention. As seen in Figure 1, a 

10 database server 10 includes a database 12 and a user defined fimction (UDF) 14 
which provides abstract layering for underlying electronic mail services, such as 
the e-mails service 16 provided by the e-mail server 18. When input is received by 
the database 12 which causes an action to be performed on an entry in the database 
12, a database trigger of the database 12 invokes the e-mail user defined function 

15 14. The user defined function 14 instructs the e-mail service 16 to send an e-mail 
message as a result of the action on the entry in the database 12. 

As described above, embodiments of the present invention may use a 
database UDF to provide automatic generation of e-mails. In a relational database, 
UDFs can help streamline e-business operations. UDFs may facilitate close 

20 integration of object/relational database system function and e-business processes. 
With UDFs, processes may be closely intergrated, data integrity may be ensured, 
and/or costly application programming and reprogramming may be avoided, hi 
addition, UDFs and other elements of server-side logic (such as stored procedures) 
may minimize the amount of network traffic necessary to accomplish a piece of 

25 work, resulting in higher performance. 

While embodiments of the present invention are described herein with 
reference to Figure 1, as will be appreciated by those of skill in the art in light of 
the present disclosure, the present invention may be utilized in other 
configurations. For example, while the e-mail server 18 and database server 10 are 

30 illustrated as separate data processing systems in Figure 1, they could be combined 
onto a single data processing system. Furthermore, multiple data processing 
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systems could be provided for either the database server 10 and/or the e-mail server 
18. Accordingly, embodiments of the present invention should not be construed as 
limited to the configuration illustrated in Figure 1 as the present invention 
encompasses any configuration capable of carrying out the operations described 
5 herein. 

Figure 2 illustrates an exemplary embodiment of a data processing system 
230 suitable in accordance with embodiments of the present invention. The data 
processing system 230 typically includes input device(s) 232 such as a keyboard or 
keypad, a display 234, and a memory 236 that communicate with a processor 238. 
1 0 The data processing system 230 may further include a speaker 244, and an I/O data 
port(s) 246 that also communicate with the processor 238. The I/O data ports 246 
can be used to transfer information between the data processing system 230 and 
S another computer system or a network. These components may be conventional 

Ifi components such as those used in many conventional data processing systems 

Z: 15 which may be configured to operate as described herein. 

'""^ Figure 3 is a block diagram of data processing systems that illustrates 

£ systems, methods, and computer program products in accordance with 

'5 embodiments of the present invention. The processor 238 communicates with the 

memory 236 via an address/data bus 348. The processor 238 can be any 
3 20 commercially available or custom microprocessor. The memory 236 is 

representative of the overall hierarchy of memory devices containing the software 
and data used to implement the functionality of the data processing system 230. 
The memory 236 can include, but is not limited to, the following types of devices: 
cache, ROM, PROM, EPROM, EEPROM, flash memory, SRAM, and DRAM. 
25 As shown in Figure 3, the memory 236 may include several categories of 

software and data used in the data processing system 230: the operating system 
352; the application programs 354; the input/output (I/O) device drivers 358; and 
the data 356. As will be appreciated by those of skill in the art, the operating 
system 352 may be any operating system suitable for use with a data processing 
30 system, such as OS/2, AIX or System390 from hitemational Business Machines 
Corporation, Armonk, NY, Windows95, Windows98 or Windows2000 from 
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Microsoft Corporation, Redmond, WA, Unix or Linux configured to support an 
TCP/rP-based protocol connection. The I/O device drivers 358 typically include 
software routines accessed through the operating system 352 by the application 
programs 354 to communicate with devices such as the I/O data port(s) 246, the 
5 data storage 235 and certain memory 236 components. The application programs 
354 are illustrative of the programs that implement the various features of the data 
processing system 230 and preferably include at least one application which 
supports operations according to embodiments of the present invention. Finally, 
the data 356 represents the static and dynamic data used by the application 

10 programs 354, the operating system 352, the I/O device drivers 358, and other 
software programs that may reside in the memory 236. 

As is fiirther seen in Figure 3, the application programs 354 may include a 
database with e-mail UDF 360. The database with e-mail UDF 360 may carry out 
the operations described herein for generation of e-mails in response to an action 

1 5 being performed on an entry in the database. The data portion 356 of memory 236, 
as shown in the embodiments of Figure 3, may include database tables 364. 

While the present invention is illustrated, for example, with reference to a 
particular configuration in Figure 3, as will be appreciated by those of skill in the 
art, other configurations may also be utilized while still benefitting from the 

20 teachings of the present invention. Thus, the present invention should not be 

construed as limited to the configuration of Figure 3 but is intended to encompass 
any configuration capable of carrying out the operations described herein. 

Operations according to embodiments of the present invention, will now be 
described with reference to the exemplary network diagram of Figure 1 and the 

25 flowcharts of Figures 4 and 5. As seen in Figure 4, the database 12 receives 
input requesting performance of an action on a database entry (block 400). Such 
an action may, for example, be creation of an entry (e.g. insertion of a row in a 
database table), deletion of an entry or modification of an entry. Performance of 
the action on the database entry causes a database trigger to invoke the e-mail user 

30 defined function (UDF) 14 (block 405). The UDF 14 obtains information about 
the e-mail message to generate, such as the recipient, message content and the like, 
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which are associated with the entry on which the action was performed and/or with 
the action performed (block 410). The UDF 14 sends the e-mail information to the 
e-mail service 16 to cause the e-mail message to be sent (block 415). 

Figure 5 is a flowchart illustrating operations according to further 
5 embodiments of the present invention. Figure 5 will be described with reference 
to a particular example of the present invention as a program for a Web registration 
process that takes client-supplied information, stores it in DB2 Universal Database 
(UDB), then sends an appropriate e-mail (such as a thank you note or marketing 
offer) in response. In the present example, when a customer visits a Web site and 
10 registers to receive additional information, a Sendmail UDF trigger fires when the 
registration is complete. Using the personal details the customer volunteered, the 
Sendmail UDF composes an appropriate e-mail (such as a thank you or 
j[g confirmation e-mail with additional access information), and sends it to the 

;| customer. 

'"i ' 15 hi the present example, the JavaMail application programming interface 

M (API) from Sun Microsystems Inc., provides a "wrapper," or abstract layering, for 

underlying mail programs and protocols. This abstract layer declares classes, 
interfaces, and abstract methods to support the mail handling functions that are 
ly typically provided by mail systems. Part of this abstract layering of mail system 

20 functions is implemented using Internet standards. A wrapper may allow changes 
to be made without altering the underlying program. Instead of rewriting or 
modifying the underlying program, Java programming code may be provided that 
"wrappers" the function. By using Java Mail and the Java Application Framework 
(JAF), the existing mail infrastructure may be layered on top of so that the mail 

25 programs themselves need not be changed. If Sendmail changes or falls out of 

fashion, but the underlying protocols stay the same, the program should still work. 
If the message the UDF sends requires changing, the changes are made to the UDF, 
not the underlying mail program. In fact, a future maintenance progranmier doesn't 
even have to fully understand the underlying mail program, only the Java wrapper. 

30 To provide portability, the UDF may be written in Java, however, other 

programming languages may be used. In the present example, the Java UDF uses 
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Sun's JavaMail 1.1.3 API and JAF vl.O.l. JavaMail makes the calls to the 
underlying transport protocol (in the present example, SMTP running on a remote 
AIX machine) and provides a common API for managing e-mail. The Java UDF 
uses the JavaMail API to send messages. The JavaMail API also provides the 
5 capability to access message stores and to compose and send messages. To achieve 
this functionality, the JavaMail API provides the four abstract classes: transport, 
message, folder, and store. When the UDF in these examples sends mail, it uses the 
message and transport classes to access services in the implementation layer. In 
the particular exemplary embodiments, an IBM RS/6000 machine provides the 
1 0 SMTP transport services. 

The JAF specification is a data typing and registry technology that is a 
standardized extension to the Java platform. JAF extends the Java Development 
Kit (JDK) activation framework by encapsulating access to data and instantiating 
components that correspond to mail operations on the e-mail data. The Sun 
^ 15 JavaMail API and JAF may provide levels of abstraction and enhanced portability. 

"shcr 

Returning to Figure 5, the insertion of a new row into a database table is 
detected (block 500). A database trigger associated with the table calls the UDF 
stored in the database, passing it e-mail parameters, such as address of the 

lU recipient, subject, and message (block 505). The UDF itself is composed of two 

Q 

□ 20 classes, UDFSend. class and Sender.class. The UDFSend.class receives the e-mail 

parameters and provides them to the Sender.class. Sender.class makes the call to 
SMTP services running on a remote mail server (block 510). Responsive to 
receiving the call from Sender.class, the mail server sends the message (block 515). 
These operations will now be described in detail for the present exemplary 

25 embodiments. Blocks 500 and 505 describe a database trigger being activated 
when a row is inserted into a database table. Triggers in relational database 
systems define a set of actions that are activated, or triggered, by DELETE, 
INSERT, or UPDATE operations on a specified table. Triggers can be used to 
enforce data integrity and transitional business rules or, as in this example, to 

30 invoke functions that perform tasks. The Java code sample in Listing 1 (below) 
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creates a trigger named AC, which is activated after E^JSERT into the RTPI103. E- 
mail table- 
Listing 1 : Defining the trigger. 

// Create the e-mailUDF Trigger 
5 public static void 

registerTrigger (Connection con) throws Exception 
{ try 

{ Statement registerStmt con.createStatement (); 

System. out.println (" Registering Java trigger: AC"); 
10 registerStmt.executeUpdate ( 

" CREATE TRIGGER RTPI103.AC " + 

" AFTER INSERT ON RTPI103.Email " + 

" REFERENCING NEW AS N_ROW " + 

" FOR EACH ROW MODE DB2SQL " + 
1 5 " BEGIN ATOMIC " + 

" VALUES (EmailUDF (N_ROW.RECErVER, 

N„ROW.SUBJECT, 

N ROW.MESSAGE) ); " + 

" END "); 
20 }... 

The receiver, subject, and message values for the newly inserted row, N ROW, are 
passed to the UDF called emailUDF by the action of the trigger. 

UDFs in relational database systems are often extensions or additions to 

25 existing fiinctions. Different types of UDFs may be provided, including column, 
table, and scalar functions. Like most fiinctions, UDFs return some value. For 
example, table fiinctions return a table and column and scalar functions return 
single values, hi the present example, scalar fiinctions are utilized. The code in 
Listing 2 (below) registers the external scalar UDF with DB2. The first section of 

30 the create function block illustrates how to declare the input parameters as type 
VARCHAR and the retum value as type INT. The external name declaration 
defines the name of the UDF as emailUDF and the Java class associated with it as 
UDFsend class. The definition block also illustrates how to declare that the UDF 
has external action (in other words, it causes an action outside of the database 

35 system). 



Listing 2: Registering the external scalar UDF. 
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// Register the UDFs 
public static void 

registerUDFs (Connection con) throws Exception 
{ try 

{ Statement registerStmt = con.createStatement (); 
// scalar emailUDF 

System. out.println (" Registering Java UDF: emailUDF"); 
registerStmt.executeUpdate ( 

" CREATE FUNCTION emailUDF ( VARCHAR(200), 
VARCHAR(200), 
VARCHAR(700) ) " + 
" RETURNS int " + 

" EXTERNAL NAME 'UDFsend! emailUDF " + 
" LANGUAGE Java " + 
" PARAMETER STYLE JAVA " + 
" DETERMINISTIC " + 
" FENCED " + 
" NOT NULL CALL " + 
" NO SQL "+ 

" EXTERNAL ACTION " + 
" SCRATCHPAD " + 
" FINAL CALL " + 
" ALLOW PARALLEL " + 
" NO DBINFO"); 
registerStmt.close (); 

! 5=S 
: :1 i 

i,y To use the JavaMail program and JAF with the UDF code, two classes are 

created: UDFSend.class and Sender.class. Using two separate classes may facilitate 

30 development and debugging. The UDFSend.class was called by the emailUDF 
registered in Listing 2. The UDFSend.class performs two main functions: It 
accepts input arguments, such as address, subject, and message, and passes them to 
the Sender.class. The Sender.class actually makes the calls to the mail handling 
functions residing on the remote RS/6000 machines. 

35 hi the sample of the UDFSend.class code in Listing 3 (below), UDFSend 

extends UDF. hi the present example, it takes the address, subject, and message 
strings as inputs and returns the string length of the message, which was used for 
program debugging. Within the try and catch block a new instance of Sender is 
created, passing it the URL of our remote mail server. While not all of the code 
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associated with UDFSend.class is illustrated, the EmailSend() and Email To() 

methods map to the Sender.class code. 

Listing 3: A sample of the UDFSend.class code. 

UDFSend.class: 
class UDFsend extends UDF 
{ // the emailUDF UDF 
public void 

emailUDF(String inputAddr, String inputSubject, 

String inputmessage, 
int outputStrLen) throws Exception 
{ try 

{ // set(4, inputmessage. lengthQ); 
Sender smtp = new Sender("xxx.yyy.zzz.com"); 
/* EmailToQ */ 

if ( !smtp.EmailTo(inputAddr) ) { , 
//System. out.println(" EmailTo failed"); 
System. exit(l); 

} 

/* Call EmailSendO */ 
if ( !smtp.EmailSend(inputmessage) ) { 
System. out.println("Send Message failed"); 
System, ex it(l); 

} 

// System.out.println("Sender successful"); 
//System.exit(O); 
} 

catch (Exception e) 
{ throw e; 

} 
} 

The constructor of the Sender.class that actually sends the e-mail message receives 
the "host string," which is the URL of the SMTP host. In Java, a constructor is an 
instance method with the same name as its class. There are a number of methods in 
35 Sender.class, two of which are shown in the example in Listing 4 (below). Other 
methods handle Reply To, CC, From, and Subject information. For a complete 
discussion of available methods, see Sun Microsystems's JavaMail API design 
specification. As with Listing 3, Listing 4 is an exemplary portion of the code for 
the Sender.class. Remaining portions of the code of Listing 3 and Listing 4 will be 
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readily apparent to those of skill in the art in light of discussion in the present 

disclosure and, therefore, will not be described further herein. 

Listing 4: Two methods in Sender.class. 

Sender.class: 
5 class Sender { 

// Host String containing the 
// address of the smtp mail host. 
Sender(String host) { 
props = new Properties(); 
10 props.put("mail. smtp. host", host); 

session - Session. getDefaultInstance(props, null); 

session.setDebug(debug); 

message = new MimeMessage(session); 

} 

15 // 

public boolean EmailTo(String emailto) { 

boolto^true; 

try { 

message. addRecipient(Message.RecipientType.TO, 
20 new IntemetAddress(emailto)); 

} catch (MessagingException mex) { 
return false; 

} 

return true; 
25 }; 

// 

public boolean EmailSend(String messageText) { 
if ( Iboolto ) return false; 
if ( Iboolfrom ) return false; 
30 if ( Iboolsubject ) return false; 

try 

message. setSentDate(new DateQ); 
message. setText(messageText.toString()); 
Transport.send(message); 
35 } catch (MessagingException mex) { 

return false; 

} 

return true; } 

40 The flowcharts and block diagrams of Figures 1 through 5 illustrate the 

architecture, functionality, and operation of possible implementations of systems, 
methods and computer program products for e-mail generation according to 
various embodiments of the present invention. In this regard, each block in the 
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flow charts or block diagrams may represent a module, segment, or portion of 
code, which comprises one or more executable instructions for implementing the 
specified logical function(s). It should also be noted that, in some alternative 
implementations, the functions noted in the blocks may occur out of the order 
5 noted in the figures. For example, two blocks shown in succession may, in fact, be 
executed substantially concurrently, or the blocks may sometimes be executed in 
the reverse order, depending upon the functionality involved. It will also be 
understood that each block of the block diagrams and/or flowchart illustrations, 
and combinations of blocks in the block diagrams and/or flowchart illustrations, 

10 can be implemented by special purpose hardware-based systems which perform the 
specified functions or acts, or combinations of special purpose hardware and 
computer instructions. 

In the drawings and specification, there have been disclosed typical 
illustrative embodiments of the invention and, although specific terms are 

1 5 employed, they are used in a generic and descriptive sense only and not for 

purposes of limitation, the scope of the invention being set forth in the following 
claims. 
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